LUA OS ALPHA    |
By Sam and Chris|
pspevolution.com|
-----------------

I am not responsible for any damage this program may cause, use at your own risk.

Thanks for downloading LUA OS!
For the people who don't know about what it does, I'll briefly explain.
LUA OS is a shell I made in the LUA scripting language. It is designed to do
what the Lowser can do, and more. 
To use this program, you need luaplayer. I recomend using version .11 because it is
faster. If you have a higher version than that, replace the EBOOT.PBP inside of
/luaplayer with one downloaded from out site. If you do not have luaplayer, download
it at luaplayer.org. Also, some features require .15 of luaplayer, such as
LUA OS NET. So, you may want to get .15 for that. Again, .15 is slower: .11 runs at
53-58FPS, where .15 runs at 43-47FPS. (The first number is with the start bar open,
the second one is without)

-----[ Basic features ]-----
-Windows-like desktop
-Launchable icons
-Multiple desktop support
-Themes
-Screensavers
-Start bar with time, battery, and Start menu
-Settings, which include Themes and Screensaver
-Included Programs, for easy access
-Small PNG viewer
-Additional small features, such as debuging and windows


-----[ Installation ]-----
Put the 'LUA OS' folder into PSP/GAME/luaplayer/Applications/

If you would like to make LUA OS start instead of the Lowser, do the following:
 1. Open luaplayer/System/system.lua
 2. On the 4th line, it mentions "Lowser". Change it to "LUA OS" (if you changed the
 foldername to something else, use that name instead.)
 3. Save it.


-----[ Controls ]-----
I tried to make the controls as simple as possible.

[ When your on the desktop ]
 X will run a program or enter a folder
 Triangle will go into a folder, even if there is an index.lua inside
 Analog stick moves the cursor
 L and R switch between desktops
 Start exits the shell
 Hold X to draw a little selection box (Doesn't do anything as of yet)

[ While a window is open ]
 X selects
 Pushing X on the close button on the top right of the window closes it
 Select is a shortcut to close (It's like ALT-F4)
 Hold X on the title bar to drag it around
 When you see a set of arrows, that means use the D-PAD. Don't try to click on them.


-----[ Functions ]-----
[ Themes ]
 I have added theme support, basicly you can add images into a folder inside the 
 /themes folder to make a theme. You can change all of the images, except for the
 arrows that show up in the screensaver options. Here is a list of what the file
 names are:
 __________________________________________________________________________________
 |Name          |Filename       |Description          
*|Splash Screen |splash.png     |The splash image that is displayed while loading
 |Start Menu    |startmenu.png  |The Start menu
 |Start Bar     |bar.png        |The bar at the bottom of the screen
 |Battery icon  |battery.png    |Changing this image is not recomended. If the 
 |              |               |color of the bar is the same as the icon, change
 |              |               |the bar instead.
 |System Message|message.png    |The window when an error comes up
 |Background    |background.png |The background of the desktop
 |Cursor        |cursor.png     |The mouse
*|LUA icon      |icon.png       |The icon when a program doesn't have an icon.png
*|Folder icon   |folder.png     |The folder icon
*|Unknown file  |plain.png      |The icon for an unknown file
*|PNG icon      |pngviewer.png  |The icon for a PNG file to be opened by the viewer
 |Window        |window.png     |The window for Settings, 
*|Screensaver   |screensaver.png|The image in the default and bouncing screensaver
 |Battery icon  |battery.png    |The battery image, replace if Start Bar is white
*|Preview icon  |preview.png    |The icon shown in the theme selector
*|Theme icon    |theme.png      |The icon for a theme without preview.png
 __________________________________________________________________________________
  * indicates that the image can be any size

[ Screensaver ]
 There are 3 screensavers, 'default', 'bouncing', and 'starfield'. In the 'default'
 screensaver, the screensaver image randomly appears on the screen. In the
 'bouncing' screensaver, the image bounces off the sides of the screen. In the
 'starfield' screensaver, it makes the screen look like a starfield. (The starfield
 code was made by Shine)
 To exit the screensaver, push a button or move the analog.
 The settings for the screensaver are 'Wait:' and the selection. 'Wait:' means how
 long to wait until it is activated. Use the D-PAD to change the settings.
 NOTE: The screensaver code is not meant to be modified

[ Multiple Desktops ]
 The multiple desktop feature simply means that if there are more than 24 icons,
 you can push L or R to show the additional icons. There is no limit to how many
 desktops there can be.

[ Start Bar ]
 To open the start bar, move the mouse to the bottom of the screen. On the start
 bar, push X while over the battery icon to see information. Also, 
 if the charging cable is present, it will show a charging icon next to it.
 Push X while over the START button to open the menu.

[ Included Programs ]
 Click on 'Programs' in the start menu. You can access Tools, LuaPlayer Samples, and
 LUA OS NET (version .15 only)

[ LUA OS NET ] (version .15 only)
 A very cool feature is LUA OS NET. With this feature, you can view news and
 posts about the features, updates, ect. The update feature has been disabled until
 it can work well enough to be considered stable.

[ PNG Viewer ]
 To launch the viewer, click on a .png file. The viewer will exit when you push
 Start

[ Credits ]
 Press X over the 'LUA OS' on the start menu


-----[ Launching Programs ]-----
 To launch a program, simply press X over it. A program can be an .lua file, or an
 index.lua file inside a folder. If it is inside a folder, you can include an
 icon.png to display as the icon for it. if you want to enter a folder that has
 an index.lua, press triangle. The folder named '..' means go back a folder.


-----[ Bugs ]-----
 -The only that I can find is sometimes you will get an error that talks about
  char(0). When you push Start to restart luaplayer, it gives you the error again.
  This has only happend once on a PSP other than mine, so it may not happen that
  often. To get back into luaplayer, hold power for 5 seconds and relaunch the 
  program.


-----[ TODO ]-----
 -LUA OS has error handling. This means that if your code generates an error, it
  will show up in a message inside of LUA OS. The problem with this is that if you
  use the print() function, the message is hidden and LuaPlayer must be restarted
  blindly. If you think your program created an error, press select once and hold
  start.
 -I would like to use Durante's globalcallback code so that if, while running a
  program, you get stuck, you can push L, R, START, and SELECT to quit back to LUA
  OS. Although it is working, some users may not want it, so I will add it as a
  setting in the future along with the error handling.
 -Make the start bar's middle part do something.
 -Small, simple MOD player that has basic stop, pause, play, and volume functions.
  It will also have an icon near the battery icon
 -Other stuff I can think of.


-----[ About ]-----
 This program was made by Sam and Chris from TeamEvolution. You can visit our 
 webpage at pspevolution.com.
 I would also like to thank PSPUpdates (pspupdates.qj.net) for being such a great
 site!
 If you need to contact us, click on our usernames at our website.
 Also, if you have, or would like to, make a theme to be included, 
 please contact us!